Skip to content

Finalize verified releases through robot approval gates - #592

Draft
waveywaves wants to merge 11 commits into
tektoncd:mainfrom
waveywaves:fix-release-robot-finalization
Draft

waveywaves wants to merge 11 commits into
tektoncd:mainfrom
waveywaves:fix-release-robot-finalization

Conversation

@waveywaves

@waveywaves waveywaves commented Nov 17, 2026 •

Copy link
Copy Markdown
Member

Changes

Publish or repair an existing release through a protected main-branch workflow,
so signing checks and finished-artifact installation happen before publication
or optional latest promotion.

  • Require the real GitHub and registry credentials to belong to tekton-robot,
    a protected maintainer approval environment, and an independently configured
    public key.
  • Verify the exact candidate and source, run the finished-release smoke test,
    and reject changed release metadata or asset IDs.
  • Select Rekor provenance by the hash of the exact verified statement payload,
    then preserve the other release notes while correcting attestation commands.
  • Promote only the approved image digest and verified manifest bytes; publish
    the existing release with explicit tag/source fields after those checks pass.
  • Support notes-only repair without publishing a draft or promoting latest.
  • Recheck the actual tag before promotion and after publication so a changed
    source cannot be hidden by unchanged release metadata.
  • Keep generated notes repairable after finalization by preserving the
    attestation section boundary.
  • Run deterministic boundary tests in CI and document provisioning and retries.

All 23 deterministic finalization cases pass, including finalize-then-repair
with generated notes and a conflicting tag before publication. The inherited
verifier passes 62 cases. No live publication, promotion, infrastructure apply or new release
trigger ran. The clean finished-release smoke in #591 passed
installation, mutation, admission and completion.

Dependencies: merge #591 first; provision the environment and independent
signing trust from tektoncd/plumbing#3808 before enabling this workflow.

/kind feature

Submitter Checklist

As the author of this PR, please check off the items in this checklist:

  • Has Docs if any changes are user facing, including updates to minimum requirements e.g. Kubernetes version bumps
  • Has Tests included if any functionality added or changed
  • Follows the commit message standard
  • Meets the Tekton contributor standards (including functionality, content, code)
  • Has a kind label. You can add one by adding a comment on this PR that contains /kind <type>. Valid types are bug, cleanup, design, documentation, feature, flake, misc, question, tep
  • Release notes block below has been updated with any user facing changes (API changes, bug fixes, changes requiring upgrade notices or deprecation warnings). See some examples of good release notes.
  • Release notes contains the string "action required" if the change requires additional action from users switching to the new release

Release Notes

NONE

Recognize DSSE provenance entries and fail when no provenance can be found instead of substituting an image-signature entry. Pin the shared release task with corrected attestation instructions.

Depends on tektoncd/plumbing#3807.

Assisted-by: OmO
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Check metadata, bucket copies, image platforms and signed provenance before retaining immutable verification receipts.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Remove latest inputs and publication paths; reject legacy promotion before side effects and verify the shipped guard during release configuration checks.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Install the immutable manifest and image, require webhook mutation, admission and PipelineRun success, and retain diagnostics while cleaning only the owned cluster.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Use PipelineRunPending from the actual admission response and reject the incorrect Pending value in the deterministic boundary test.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Verify the exact candidate and smoke its published artifacts before optional latest promotion. Bind repaired provenance notes to verified payloads and retain publication state during repair.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
@tekton-robot

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
To complete the pull request process, please ask for approval from waveywaves after the PR has been reviewed.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@codecov-commenter

codecov-commenter commented Nov 17, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.81%. Comparing base (c0c2d21) to head (b491133).

Additional details and impacted files

Impacted file tree graph

@@             Coverage Diff             @@
##             main     #592       +/-   ##
===========================================
+ Coverage   55.69%   73.81%   +18.12%     
===========================================
  Files          16       16               
  Lines        1203     1203               
===========================================
+ Hits          670      888      +218     
+ Misses        497      253      -244     
- Partials       36       62       +26     
Flag Coverage Δ
e2e-tests 52.79% <ø> (?)
unit-tests 55.69% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.
see 6 files with indirect coverage changes


Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update c0c2d21...b491133. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Watch old Pod deletion and the Service endpoint switch after rollout instead of relying only on Deployment availability.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Print candidate identifiers without Markdown command delimiters so the required workflow shell lint accepts the summary.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Append the attestation boundary so a finalized recovery draft can be repaired repeatedly without losing its generated notes.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Peel existing tags and fail on source conflicts or lookup errors. Permit missing tags only for candidates that have not been published.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Reuse the verifier tag check before promotion and after publishing, and reject a tag changed during candidate checks.

Assisted-by: OpenAI
Signed-off-by: Vibhav Bobade <vibhav.bobde@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants